home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / msatcm.zip / MSATCOM.DOC < prev    next >
Text File  |  1991-09-26  |  18KB  |  484 lines
  1. (*****************************************************************************)
  2. (*                                                                           *)
  3. (*             MSATCOM(tm) - MicroSat Ground Station Terminal                *)
  4. (*                                                                           *)
  5. (*                              Version 1.0                                  *)
  6. (*                                                                           *)
  7. (*            (c) Copyright 1990 by Claudio M. Zanella LU4AEY                *)
  8. (*                     Released For Public Distribution                      *)
  9. (*                           ALL RIGHTS RESERVED                             *)
  10. (*                                                                           *)
  11. (*****************************************************************************)
  12.  
  13.  
  14.     UTILIDAD
  15.  
  16.     Terminal de comunicaciones digitales protocolo FTL0 (File Transfer Level 0)
  17.  
  18.  
  19.     REQUERIMIENTO DE SOFT
  20.  
  21.     - MSATCOM.EXE    Programa principal (versión en inglés)
  22.     - README.COM     Programa para lectura del archivo THUNDER.DOC
  23.     - MSUSER.DOC     Este documento
  24.     - MSATCOM.CNF    Archivo de configuración del sistema
  25.  
  26.     REQUERIMIENTO DE HARDWARE
  27.  
  28.     MSATCOM puede  ser utilizado en PC, XT, AT y Compatibles, requiere para
  29.     su  funcionamiento TNCs con comandos tipo TAPR y una completa  conexión
  30.     del port RS232 patas 1,2,3,4,5,6,7,8,20 (Tener especial atención en las
  31.     patas: 8 Data Carrier Detect, 4 Request to Send y 5 Clear to Send).
  32.  
  33.     En PACCOMM TNC 220 - 320 setear JP-C en CONN (Default es HIGH)
  34.  
  35.     Es recomendable el uso del siguiente CONFIG.SYS:
  36.  
  37.     FILES = 20
  38.     BUFFERS = 20
  39.  
  40.     MSATCOM fue testeado con el siguiente HARDWARE:
  41.  
  42.     Tipos de TNC:
  43.  
  44.     PACCOMM TINY 2
  45.     PACCOMM TNC 200
  46.     PACCOMM TNC 220
  47.     PACCOMM TNC 320
  48.     MFJ-1270/1278
  49.     AEA PK 232
  50.     AEA PK88
  51.  
  52.     Tipo de computadoras:
  53.  
  54.     PC AT 80386   20/25 MHz
  55.     PC AT 80286   16/20 MHz
  56.     PC AT 80286   12/16 MHz
  57.     PC XT 80286    8/12 MHz
  58.     PC XT 8088     4/10 MHz       PC XT NEC V20 10/12 MHz
  59.  
  60.     SETEO DEL TNC
  61.  
  62.     Este programa utiliza Hardware Handshaking. Setee su TNC en NO  PARIDAD
  63.     y EL LARGO DE PALABRA en 8 BITS.
  64.  
  65.     CPactime OFF
  66.     CR       ON
  67.     SEnd     $0D
  68.     DCD      ON  <-- Detect Carrier Externo en PK232
  69.  
  70.     Habilite el Harddware Handshaking de su TNC de la siguiente forma:
  71.  
  72.     START  0
  73.     STOP   0
  74.     XFLOW  OFF
  75.     XON    0
  76.     XOFF   0
  77.  
  78.     Se recomienda el uso de los siguientes parámetros:
  79.  
  80.     TXDEALY 20
  81.     AXDELAY 20
  82.     PRIOACK ON <-- Release TAPR 1.1.7 solamente
  83.     FLOW    ON
  84.  
  85.     SUMARIO DE COMANDOS
  86.  
  87.     Los siguientes comandos están disponibles en MSATCOM:
  88.  
  89.     F1         - Solicitar envio de Directorios.
  90.     F2         - Solicitar recepcion de archivos (DOWNLOAD).
  91.     F3         - Solicitar el envio de archivos (UPLOAD).
  92.     F4         - Activa/Desactiva la imprsora en modo Directorio.
  93.     F5         - Reveer pantalla de directorios bajados.
  94.     F6         - Ajustar tiempo de peticion de directorios Generales  (ALL).
  95.     F7         - Ajustar tiempo de peticion de directorios Personales (MY).
  96.     F8         - Ajustar tiempo de peticion de directorios Boletines  (BUL).
  97.     F9         - Cambio de satelite corriente.
  98.     F10        - Gateway al DOS.
  99.  
  100.     Alt-B      - Enviar señal de break al TNC para ponerlo en modo comando.
  101.     Alt-D      - Cambiar nivel de Data Carrier Detect (DCD pin 8 v24).
  102.     Alt-H      - Pantallla de Ayuda (HELP).
  103.     Alt-R      - Reorganizar los archivos que contiene los directorios.
  104.     Alt-T      - Modo Terminal / Modo Server.
  105.     Alt-X      - Finalizar ejecución de MSATCOM (Retorno al DOS).
  106.  
  107.     DESCRIPCION DEL USO DE COMANDOS
  108.  
  109.     TECLA F1 (DIRECTORY):
  110.     Pulsando F1 se ingresa a las opciones de DIRECTORIO. Hay cuatro opciones
  111.     disponibles en esta modalidad:
  112.  
  113.     ALL      -  Recibir los File Header desde la ultma solicitud.
  114.     PERSONAL -  Recibir los File Header enviados a  nuestra  licencia desde la
  115.                 ultima solicitud.
  116.     BULLETIN -  Recibir los File Header enviados a ALL (TODOS) desde la ultima
  117.                 solicitud.
  118.     SEARCH   -  Recibir los File Header  que contenga el criterio  de busqueda
  119.                 especificado por Ud. tomando como referecia el tiempo desde la
  120.                 ultima solicitud a ALL.
  121.  
  122.     Para corregir los tiempos de ultima solicitud ver las opciones F6, F7 y F8
  123.     los  mismos  estan  contenidos  en  los  archivos MSTIME.ALL, MSTIME.MY  y
  124.     MSTIME.BUL en formato UNIX Hexadecimal.
  125.  
  126.     TECLA F2 (DOWNLOAD):
  127.     Por  intermedio de esta  tecla accedemos a la  opcion DOWNLOAD (BAJAR). Su
  128.     uso es muy simple y consiste en indicar el valor HEXADECIMAL de archivo el
  129.     cual nos interesa recibir.
  130.  
  131.     Este quedara memorizado hasta tanto el proceso de BAJADA haya concluido ya
  132.     sea con exito o no, es decir que si por algun motivo la BAJADA del archivo
  133.     no  finalizo  y  el  contacto  con el  server se  pierde, en la  siguiente
  134.     oportunidad bastara con  pulsar nuevemte F2  y automaticamente el programa
  135.     reiniciara la operacion de BAJADA desde el offset donde perdio el contacto
  136.  
  137.     ATENCION: Esto  se repetira hasta  tanto el  programa no reciba el COMANDO
  138.               DATA END  o bien el DOWNLOAD_ERR_RESP  que saque del Status  PDL
  139.               al archivo de BAJADA.  En caso  de querer abortar Ud. esto BORRE
  140.               desde su DOS el archivo de BAJADA corriente.
  141.  
  142.     Status de los Archivos:
  143.  
  144.     xxxxxx.PDL   : Archivo en proceso de Bajada (Esta no ha finalizado).
  145.     xxxxxx.DL    : Archivo ha sido bajado con exito.
  146.     xxxxxx.XDL   : Archivo rechazado (Se produjo un error en la bajada).
  147.  
  148.     xxxxxx       : Numero Hexadecimal del Archivo requerido.
  149.  
  150.     TECLA F3 (UPLOAD):
  151.     Al  pulsar esta opcion  se accede al UPLOAD (SUBIR) la cual nos permite el
  152.     envio de archivos en formato FT Level 0 al server del Microsatelite.
  153.     Al igual que el DOWNLOAD, la opcion UPLOAD queda memorizada hasta tanto el
  154.     proceso de SUBIDA haya concluido exitosamente o no.
  155.  
  156.     Si no se  logra finalizar  el envio por perdida del contacto con el server
  157.     en  la siguiente oportunidad podremos  reiniciar el envio  desde el offset
  158.     donde se haya interrumpido el proceso.
  159.  
  160.     El  UPLOAD en todos los casos es de acceso inmediato, es decir que una vez
  161.     pulsada  esta opcion , de  encontrarse  archivos para enviar, el  programa
  162.     inicia el procedimiento de conexion.
  163.  
  164.     Status de los archivos:
  165.  
  166.     mmmmmm.OUT   :  Archvio en proceso inicial de envio.
  167.     xxxxxx.PUL   :  Archivo en proceso de envio (Este se ha interrumpido).
  168.     xxxxxx.UP    :  Archivo ha sido subido con exito.
  169.     xxxxxx.XUL   :  Archivo rechazado, se produjo algun error en la subida.
  170.  
  171.     mmmmmm       :  Nombre inicial del archivo.
  172.     xxxxxx       :  Numero Hexadecimal asigando por el server
  173.  
  174.     TECLA F4 (PRINTER TOGGLE):
  175.     Esta  opcion permite poner  o sacar de linea a la impresora. La misma sera
  176.     utilizada en el proceso DIRECTORY, es decir que podremos obtener una copia
  177.     en papel del directorio del server a  medida que lo estemos recibiendo, de
  178.     esta forma la operatoria de DOWNLOAD se agiliza notablemente.
  179.  
  180.     TECLA F5 (RELOAD/REVIEW DIRECTORY):
  181.     La funcion de  esta opcion es  permitirnos cargar y sortear (Reordenar) en
  182.     memoria los directorios recibidos del  server corriente, a la vez  que son
  183.     mostrados en la pantalla desde el mas nuevo al mas viejo.
  184.  
  185.     Por medio de las teclas PageUp y PageDwn se podra saltar por pagina entera
  186.     estos directorios. Las teclas Cursor  Arriba y Cursor Abajo podremos hacer
  187.     subir o bajar por linea.  La  tecla Home posiciona la pantalla al comienzo
  188.     del directorio. La tecla End posiciona la pantalla al final del directorio
  189.     La tecla W permite grabar en un archivo, los directorios de pantalla.
  190.  
  191.     Los mensajes dirigidos a nuestra licencia  seran resaltados  con el fin de
  192.     indicarnos la presencia de esta en la lista.
  193.  
  194.     Un sub-proceso es ejecutado al correr esta opcion. Este consiste en cargar
  195.     en una sublista los directorios.
  196.  
  197.     Este sub-proceso asegura que los File  Header recibidos durante el proceso
  198.     DIRECTORY no se repitan, es decir que no se generen Directorios duplicados
  199.     Si se detecta la presencia de un Directorio duplicado, este es indicado en
  200.     pantalla, pero no es grabado en el archivo maestro.
  201.  
  202.     TECLAS F6, F7, F8 (TIME ADJUSTMENT):
  203.     De estas  opciones  dependen los tiempos de requisito de los directorios.
  204.  
  205.     MSATCOM raliza todos los pedidos de directorios tomando como referencia el
  206.     tiempo actual de  los archivos MSATCOM.BUL, MSATCOM.ALL o MSATCOM.MY segun
  207.     sea el caso.
  208.  
  209.     Estos archivos seran actualizados  luego de haber concretado una solicitud
  210.     de directorio, para ello se toma como referencia el tiempo del ultimo File
  211.     Header en el server.
  212.  
  213.     Un vez actualizado, este tiempo podra ser alterado con estas opciones,  la
  214.     misma consiste en indicarle al programa la diferencia en horas de  nuestra
  215.     hora GMT.
  216.  
  217.     El formato  de estos archivos  es HEXADECIMAL  y corresponde  al tiempo en
  218.     UNIX.
  219.  
  220.     Los  mismos  seran  creados por primera vez por  el programa, tomando como
  221.     referencia el tiempo actual del programa.
  222.  
  223.     TECLA F9 (CHANGE COURRENT SATELLITE):
  224.     Esta  opcion, de acceso inmediato, permite cambiar en forma instantanea el
  225.     satelite corriente del programa.
  226.  
  227.     De esta forma se puede cambiar la configuracion del programa para el nuevo
  228.     satelite, sin tener  que abandonarlo  para  realizar cambios al archivo de
  229.     configuracion, el cual hace perder tiempo y realiza mas complejo su uso.
  230.  
  231.     TECLA F10 (DOS GATEWAY):
  232.     Permite  realizar  un  shell  al DOS  para ejecutar comandos  o  programas
  233.     externos a MSATCOM.
  234.  
  235.     TECLA ESC (ABORT & DISCONNECT):
  236.     Esta tecla permite abortar cualquier operacion iniciada en forma inmediata
  237.     produciendo un reseto total del estado de las variables del programa.
  238.  
  239.     TECLA ALT-B (SEND BREAK):
  240.     Permite enviar una señal de ruptura de 350 ms cuando nos encontramos en el
  241.     modo terminal con el objeto de poner al TNC en modo COMANDO.
  242.  
  243.     TECLA ALT-D (DCD LEVEL):
  244.     Permite cambiar el estado logico del DCD, esta opcion fue incorporada con
  245.     el fin de permitir el uso de TNC's que que usan como DCD VALIDO un estado
  246.     Alto, siendo el estado Bajo el comunmente encontrado en los TNC's.
  247.  
  248.     TECLA ALT-H (HELP SCREEN):
  249.     Esta opcion nos da acceso a una pequeña ayuda en pantalla de los comandos
  250.     del programa.
  251.  
  252.     TECLA ALT-R (REBUILD DIRECTORY):
  253.     Utilizada  para  un  reorganizado del  archivo  directorio  del  satelite
  254.     corriente.
  255.  
  256.     Esta reorganizacion consiste en depurar al archivo directorio de posibles
  257.     directorios  duplicados  a  la vez  borrar  los  viejos, posteriores a la
  258.     cantidad de dias que nosotros le indiquemos.
  259.  
  260.     TECLA ALT-T (TERMINAL/SERVER MODE):
  261.     Por  medio de esta opcion podremos pasar del modo SERVER al modo TERMINAL
  262.     en forma instantanea y rapida.
  263.  
  264.     TECLA ALT-X (EXIT TO DOS):
  265.     Finalizar ejecución de MSATCOM (Retorno al DOS).
  266.  
  267.                                    --- ** ---
  268.  
  269.                      Configuracion del archivo MSATCOM.CNF
  270.                      -------------------------------------
  271.  
  272.     Como vimos al  comienzo, este archivo  es el encargado  de configurar el
  273.     sistema, el mismo esta dividido en cuatros secciones (Serial SetUP, Misc
  274.     Function,  Top_Cmd_Start/End_Cmd_Setup y Top_Cmd_End/End_Cmd_Setup).  La
  275.     primera  y  segunda  estan  destinadas  a  enviar  distintos comandos al
  276.     programa propiamente dicho y las dos restantes tienen por mision  enviar
  277.     comandos al  TNC para  setearlo en  su inicio  y al  salir del programa,
  278.     estos ultimos pueden ser configurados por el usuario.
  279.  
  280.                               Configuracion Tipica
  281.                               --------------------
  282.  
  283.     En la  primera seccion  (Serial SetUP)  encontramos como  comienzo de la
  284.     misma el seteo  de velocidad para  la comunicacion de  la computadora al
  285.     TNC, es necesario que ambos coincidan en esta velocidad, es decir que el
  286.     TNC en este caso debera estar seteado a 9600 Baud.  El largo de palabra,
  287.     la paridad y el  bit de parada deben  coincidir con el seteo  previo del
  288.     TNC.    Tres  opciones  existen  para  el  Handshake  y  estas  son  las
  289.     siguientes:  H (hardware, RTS/CTS) , S (software, XON/XOFF) y N  (none).
  290.     La mas aconsejada es la de Hardware.
  291.  
  292.     Tambien es posible setear el puerto de comunicaciones a usar en  nuestra
  293.     computadora con la opcion de Com_Port y es necesario hacerlo indicandolo
  294.     con numeracion exadecimal, agregando en el siguiente seteo (IRQ_Com)  el
  295.     numero correspondiente de interrupcion, por ejemplo:
  296.  
  297.                               Port 1 = $03f8  IRQ4
  298.                               Port 2 = $02f8  IRQ3
  299.                               Port 3 = $03e8  IRQ4
  300.                               Port 4 = $02e8  IRQ3
  301.  
  302. #
  303. #              MSATCOM version 1.0  --  Configuration FILE  --
  304. #
  305. # Serial SetUP
  306. #
  307. #
  308. Baud_Rate   = 9600
  309. #
  310. Word_Lenght = 8
  311. #
  312. Parity      = N
  313. #
  314. Stop_Bit    = 1
  315. #
  316. Handshake   = H
  317. #
  318. Com_Port    = $03F8
  319. #
  320. IRQ_Com     = 04
  321. #
  322. #
  323.  
  324.     En  la  segunda  seccion   (Misc  Function),  tenemos  las   dos  primeras
  325.     instrucciones  que  corresponden  al  tipo  de  placa de video que se usa,
  326.     normalmente  Not  y  Yes  son  los  mas  usados,  pero en algunos casos es
  327.     necesario cambiar Not/Yes para  un mejor funcionamiento dependiendo  de la
  328.     placa de video.
  329.  
  330.     SYSOP_NAME:  como la  plabara lo dice ,  es necesario colocar el  nombre
  331.     del operador del sistema.
  332.  
  333.     MYCALL: licencia del operador.
  334.  
  335.     GMT_ZONE:  esta pensado para  que el programa utilize la  hora universal
  336.     coordinada, tomando para ello la hora de la computadora, es por ello que
  337.     debemos tener  la precaucion  de mantener  en hora  nuestra maquina y en
  338.     este caso debemos indicar si nuestra estacion se encuentra al este o  al
  339.     oeste de Grenwich de la siguiente manera:  EST  o  WES
  340.  
  341.     GMT_HOURS:  este  comando  funciona  paralelamenta  al  anterior  y   es
  342.     necesario indicar la diferencia horaria  que existe entre nuestro QTH  y
  343.     la hora de Grenwitch siempre en numero positivo.
  344.  
  345.     SATELLITE:  Debera ser colocada la licencia del satelite al que deseamos
  346.     conectar, sin omitir el numero que correspondiera despues del guion y en
  347.     este  caso  es  el  numero  12,  que  para  todos  los  satelites el -12
  348.     identifica al BBS  durante la ejecucion del programa se puede cambiar de
  349.     satelite (F9) sin modificar la configuracion
  350.  
  351.     DCD_LEVEL: Nivel logico del DCD  L (bajo) o H (alto)
  352.  
  353.     SORT_TYPE:  Esta instruccion es usada por la opcion F6 para realizar  la
  354.     clasificacion del  directorio y en  este caso sera realizada  por tiempo
  355.     (TIME), es decir que se vera en la pantalla desde la fecha mas  reciente
  356.     a la mas antigua.  Tambien es posible que podamos hacer la clasificacion
  357.     por otro parametro como por ejemplo SIZE (tama#o).
  358.  
  359.  
  360. # Misc Function
  361. #
  362. #
  363. Snow_Check    = Not
  364. #
  365. Direct_Video  = Yes
  366. #
  367. #
  368. Sysop_Name    = Ruben
  369. #
  370. Mycall        = LU6DYD
  371. #
  372. GMT_ZONE      = EST
  373. #
  374. GMT_HOURS     = 3
  375. #
  376. SATELLITE     = SIMSAT-12
  377. #
  378. DCD_LEVEL     = L
  379. #
  380. SORT_TYPE     = TIME
  381. #
  382. #
  383.  
  384.     En la tercera seccion tenemos la posibilidad de colocar los parametros
  385.     del TNC  que creemos conveniente  enviar al arrancar el programa estos
  386.     parametros  seran  enviados  al TNC en  forma automatica y  pueden ser
  387.     modificados  por el  usuario para una mejor operacion  con el satelite
  388.  
  389.  
  390. *** Top_Cmd_Start
  391. #
  392. #
  393. FULLD ON
  394. FRAC 2
  395. CONOK OFF
  396. MAX 7
  397. PAC 255
  398. TXD 25
  399. AXD 25
  400. UN SIMSAT V SIMSAT-1
  401. BT SIMSAT Simulador Terrestre de Micro Satelites - Buenos Aires ARGENTINA.
  402. B E 5
  403. M ON
  404. CONMODE TRANS
  405. #
  406. *** End_Cmd_Setup
  407. #
  408.  
  409.     La cuarta seccion es identica a  la tercera pero los parametros se  envian
  410.     al TNC cuando salimos del programa (ALT-X) tambien estos parametros pueden
  411.     ser modificados  por el  usuario principalmente  aquellos que  utilicen el
  412.     mismo TNC para operacion en satelites y terrestre.
  413.  
  414.  
  415. #
  416. *** Top_Cmd_End
  417. #
  418. #
  419. FULLD OFF
  420. CONMODE CONVERSE
  421. MCOM ON
  422. UN CQ
  423. B E 0
  424. BT %
  425. CONOK ON
  426. MON OFF
  427. #
  428. *** End_Cmd_Setup
  429. #
  430.  
  431.                                    --- ** ---
  432.  
  433.     REPORTE DE ERRORES:
  434.  
  435.     Debido a que el programa aun  se encuentre en etapa desarrollo es  posible
  436.     que se puedan llegar a dar errores.   Si esto asi favor preste atencion  a
  437.     lo siguiente:
  438.  
  439.     Algunos  errores  en  el  momento  de  la  ejecucion hacen que el programa
  440.     visualice un mensaje de error y termine.
  441.  
  442. Run time error: nnn at xxxx:yyyy
  443.  
  444. nnn       : Numero de error.
  445. xxxx:yyyy : Direccion del error (segmento y desplazamiento).
  446.  
  447. Los errores en tiempo de corridad se dividen en cuatro tipos:
  448.  
  449. Errores de D.O.S.               : Del 1 al 99.
  450. Errores de Entrada/Salida (I/O) : Del 100 al 149.
  451. Errores criticos                : Del 150 al 199.
  452. Errores fatales                 : Del 200 al 255.
  453.  
  454. Anote esta informacion  y enviemela con  el fin de poder  evaluar y corregir
  455. el posible error.
  456.  
  457.            --------------------------------------------------------
  458.  
  459.                               *** ATENCION ***
  460.  
  461.     Radioaficionados:
  462.     ----------------
  463.  
  464.     Para  su distribución no se solicita ningún tipo de arancel; si Ud.  es
  465.     poseedor  de MSATCOM, por favor hágamelo saber a efectos de llevar  una
  466.     estadística  de uso, como así también cualquier tipo de error  que  Ud.
  467.     pueda llegar a detectar o sugerencias para su mejora.
  468.  
  469.     A tal efecto remita mail via Packet Radio a:
  470.  
  471.     LU4AEY @ LU4AEY.#VDP.ARG.SA Claudio M. Zanella
  472.  
  473.     Por correo a:
  474.  
  475.     Claudio  M.  Zanella
  476.     Av. Alvarez Jonte 3353 Piso 1 Dto  2  Villa del Parque
  477.     CP (ZIP) 01407 Buenos Aires - ARGENTINA. TE: 001-01-567-1239.
  478.  
  479.                              * * * * * * * *
  480.  
  481.     Que lo disfrute!
  482.  
  483.                       ...  Claudio
  484.